efa inventory admin-state

Changes, displays, and deletes device state, state change history, or state change record.

Syntax

efa inventory admin-state up [ --ip ip-addr ]

efa inventory admin-state down [--ip ip-addr ]

efa inventory admin-state detail [--uuid uuid ]

efa inventory admin-state delete [ --key ip-addr ]

efa inventory admin-state history [--ip ip-addr ]

efa inventory admin-state show [--ip ip-addr ]

Parameters

--ip ip-addr: Specifies the IP address of the device.
--key ip-addr: Specifies the IP address of the device or config-backup UUID to be deleted.
--uuid uuid: Specifies the ID of the configuration backup.

Usage Guidelines

When a device changes to admin down state, the device goes into maintenance mode.

When a device changes to admin up state, the device is taken out of maintenance mode.

For more information, see "Administered Partial Success" in the .

Examples

This example changes the device state to admin up and generates a UUID to use in the efa inventory admin-state detail version of the command.

$ efa inventory admin-state up --ip 10.24.80.158
AdminStateUp [success]
Admin State Up execution UUID: 8d9fa0cf-dc76-42cc-ac7a-57902a47c1b2

This example changes the device state to admin down and generates a UUID to use in the efa inventory admin-state detail version of the command.

$ efa inventory admin-state down --ip 10.24.80.158
AdminStateDown [success]
Admin State Down execution UUID: 28eb0845-7a7a-4851-b453-b3020c6900f2

This example displays the history of the admin status for the specified device.

# efa inventory admin-state history --ip 10.24.80.158
--------------------------------------------------------------------------
UUID 	                           Device IP     Admin State  Status   
--------------------------------------------------------------------------
8d9fa0cf-dc76-42cc-ac7a-57902a47c1b2   10.24.80.158  up 	  success  
--------------------------------------------------------------------------
28eb0845-7a7a-4851-b453-b3020c6900f2   10.24.80.158  down        success  
--------------------------------------------------------------------------
Device State Change Records

This example shows details of admin state changes for the specified UUID.

$ efa inventory admin-state detail --uuid 
28eb0845-7a7a-4851-b453-b3020c6900f2

--------------------------------------------------------------------+
NAME 	       VALUE
--------------------------------------------------------------------+
UUID 	       28eb0845-7a7a-4851-b453-b3020c6900f2
--------------------------------------------------------------------+
Device IP          10.24.80.158
--------------------------------------------------------------------+
Admin State Action down
--------------------------------------------------------------------+
Status 	     success
--------------------------------------------------------------------+
Maintenance Mode Enable Status 	success
--------------------------------------------------------------------+
Start Time 	2020-07-30 10:04:33.982447 +0000 UTC
--------------------------------------------------------------------+
Last Modified    2020-07-30 10:04:38.437425 +0000 UTC
--------------------------------------------------------------------+
Duration 	 4.454976211s
--------------------------------------------------------------------+

This example shows details of the state of the specified device.

$ efa inventory admin-state show --ip 10.24.80.158
----------------------------------+
NAME 	            VALUE
----------------------------------+
Device IP 	       10.24.80.158
----------------------------------+
Admin State             up
----------------------------------+
Health Check Status     Disable
----------------------------------+

This example deletes the state change instance for the specified IP address.

$ efa inventory admin-state delete --key 10.24.80.159
--------------------------
USERKEY 	STATUS 	ERROR
--------------------------
10.24.80.159   deleted 	 
--------------------------